List Municipalities

Retrieve all active municipalities in Yucatan state

GET /municipios

List Municipalities

cURL

curl --request GET \
  --url https://api.example.com/municipios

200

{
  "data": [
    {
      "id": 123,
      "nombre": "<string>",
      "ubicacion": {
        "type": "<string>",
        "coordinates": [
          {}
        ]
      },
      "activo": true
    }
  ]
}

Overview

Retrieves the complete catalog of 106 municipalities (municipios) in the state of Yucatan, Mexico. This is a read-only catalog endpoint that returns active municipalities sorted alphabetically by name.

Authentication

This endpoint requires authentication using a Bearer token.

Authorization: Bearer YOUR_API_TOKEN

Request

No query parameters are required. The endpoint returns all active municipalities by default.

Base URL

https://api.example.com/municipios

Response

Returns an array of municipality objects with geographic coordinates.

data · array

Array of municipality objects

Show Municipio Object

id · number

Unique identifier for the municipality

nombre · string

Official name of the municipality

Example: Mérida, Valladolid, Tizimín

ubicacion · Point

Geographic coordinates in GeoJSON Point format (SRID 4326 / WGS 84)

Show Point Structure

type · string

Always "Point" for municipality locations

coordinates · array

Array with [longitude, latitude] in decimal degrees

Example: [-89.5926, 20.9674] for Mérida

activo · boolean

Indicates if the municipality is active in the system

Default: true

Success Response

200 - Success

[
  {
    "id": 1,
    "nombre": "Abalá",
    "ubicacion": {
      "type": "Point",
      "coordinates": [-89.5800, 20.6644]
    },
    "activo": true
  },
  {
    "id": 2,
    "nombre": "Acanceh",
    "ubicacion": {
      "type": "Point",
      "coordinates": [-89.4522, 20.8125]
    },
    "activo": true
  },
  {
    "id": 51,
    "nombre": "Mérida",
    "ubicacion": {
      "type": "Point",
      "coordinates": [-89.5926, 20.9674]
    },
    "activo": true
  }
]

Example Request

cURL

curl -X GET https://api.example.com/municipios \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

Geographic Data Format

Coordinates follow the GeoJSON specification with longitude first, then latitude. All coordinates use the WGS 84 coordinate system (SRID 4326).

Notes

• Results are sorted alphabetically by municipality name (nombre)
• Only active municipalities (activo: true) are returned
• The catalog contains all 106 official municipalities of Yucatan state
• Geographic coordinates represent the central point of each municipality
• This is a read-only endpoint; municipalities cannot be created or modified via the API